Remove gtkmain stuff from docs and tutorial.
authorJavier Jardón <jjardon@gnome.org>
Thu, 22 Oct 2009 03:17:29 +0000 (05:17 +0200)
committerJavier Jardón <jjardon@gnome.org>
Sun, 2 May 2010 23:51:18 +0000 (01:51 +0200)
Also, substitue the deprecated functions with the new ones in
documentation and in tests code

docs/reference/gtk/gtk-sections.txt
docs/reference/gtk/tmpl/gtkmain.sgml
docs/tutorial/gtk-tut.sgml
gtk/gtkmain.c
modules/other/gail/tests/testcombo.c
tests/testgtk.c
tests/testselection.c
tests/testtext.c

index 86e95134d9db9dcd70c76945adf9d2e2206473a2..73bc325c561d135cff37d9d0cbe9756ca6c5c0da 100644 (file)
@@ -5882,7 +5882,6 @@ gtk_init
 gtk_init_check
 gtk_init_with_args
 gtk_get_option_group
-gtk_exit
 gtk_events_pending
 gtk_main
 gtk_main_level
@@ -5912,28 +5911,7 @@ gtk_quit_remove
 gtk_quit_remove_by_data
 
 <SUBSECTION>
-gtk_timeout_add_full
-gtk_timeout_add
-gtk_timeout_remove
-
-<SUBSECTION>
-gtk_idle_add
-gtk_idle_add_priority
-gtk_idle_add_full
-gtk_idle_remove
-gtk_idle_remove_by_data
-
-<SUBSECTION>
-gtk_input_add_full
-gtk_input_remove
-
-<SUBSECTION>
-GTK_PRIORITY_REDRAW
 GTK_PRIORITY_RESIZE
-GTK_PRIORITY_HIGH
-GTK_PRIORITY_INTERNAL
-GTK_PRIORITY_DEFAULT
-GTK_PRIORITY_LOW
 
 <SUBSECTION>
 gtk_key_snooper_install
index a0b461f3d01eab497a6ab225ff05ec06592ce4b8..b7af513ac7e4993a8cee86e39e3d0a61552b9792 100644 (file)
@@ -162,18 +162,6 @@ functions such as g_signal_connect().
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_exit ##### -->
-<para>
-Terminates the program and returns the given exit code to the caller. 
-This function will shut down the GUI and free all resources allocated 
-for GTK+.
-</para>
-
-@error_code: Return value to pass to the caller. This is dependent on the
-target system but at least on Unix systems %0 means success.
-@Deprecated: Use the standard exit() function instead.
-
-
 <!-- ##### FUNCTION gtk_events_pending ##### -->
 <para>
 Checks if any events are pending. This can be used to update the GUI 
@@ -485,191 +473,14 @@ Removes a quit handler identified by its @data field.
 @data: The pointer passed as @data to gtk_quit_add() or gtk_quit_add_full().
 
 
-<!-- ##### FUNCTION gtk_timeout_add_full ##### -->
-<para>
-Registers a function to be called periodically. The function will be called
-repeatedly after @interval milliseconds until it returns %FALSE at which 
-point the timeout is destroyed and will not be called again.
-</para>
-
-@interval: The time between calls to the function, in milliseconds 
-       (1/1000ths of a second.)
-@function: The function to call periodically.
-@marshal: The marshaller to use instead of the function (if non-%NULL).
-@data: The data to pass to the function.
-@destroy: Function to call when the timeout is destroyed or %NULL.
-@Returns: A unique id for the event source.
-@Deprecated: 2.4: Use g_timeout_add_full() instead.
-
-
-<!-- ##### FUNCTION gtk_timeout_add ##### -->
-<para>
-Registers a function to be called periodically. The function will be called
-repeatedly after @interval milliseconds until it returns %FALSE at which 
-point the timeout is destroyed and will not be called again.
-</para>
-
-@interval: The time between calls to the function, in milliseconds 
-       (1/1000ths of a second.)
-@function: The function to call periodically.
-@data: The data to pass to the function.
-@Returns: A unique id for the event source.
-@Deprecated: 2.4: Use g_timeout_add() instead.
-
-
-<!-- ##### FUNCTION gtk_timeout_remove ##### -->
-<para>
-Removes the given timeout destroying all information about it.
-</para>
-
-@timeout_handler_id: The identifier returned when installing the timeout.
-@Deprecated: 2.4: Use g_source_remove() instead.
-
-
-<!-- ##### FUNCTION gtk_idle_add ##### -->
-<para>
-Causes the mainloop to call the given function whenever no events with 
-higher priority are to be processed. The default priority is 
-%GTK_PRIORITY_DEFAULT, which is rather low.
-</para>
-
-@function: The function to call.
-@data: The information to pass to the function.
-@Returns: a unique handle for this registration.
-@Deprecated: 2.4: Use g_idle_add() instead.
-
-
-<!-- ##### FUNCTION gtk_idle_add_priority ##### -->
-<para>
-Like gtk_idle_add() this function allows you to have a function called
-when the event loop is idle. The difference is that you can give a 
-priority different from %GTK_PRIORITY_DEFAULT to the idle function.
-</para>
-
-@priority: The priority which should not be above %G_PRIORITY_HIGH_IDLE.
-Note that you will interfere with GTK+ if you use a priority above
-%GTK_PRIORITY_RESIZE.
-@function: The function to call.
-@data: Data to pass to that function.
-@Returns: A unique id for the event source.
-@Deprecated: 2.4: Use g_idle_add_full() instead.
-
-
-<!-- ##### FUNCTION gtk_idle_add_full ##### -->
-<para>
-Like gtk_idle_add() this function allows you to have a function called
-when the event loop is idle. The difference is that you can give a 
-priority different from %GTK_PRIORITY_DEFAULT to the idle function.
-</para>
-
-@priority: The priority which should not be above %G_PRIORITY_HIGH_IDLE.
-Note that you will interfere with GTK+ if you use a priority above
-%GTK_PRIORITY_RESIZE.
-@function: The function to call.
-@marshal: The marshaller to use instead of the function (if non-%NULL).
-@data: Data to pass to that function.
-@destroy: Function to call when the timeout is destroyed or %NULL.
-@Returns: A unique id for the event source.
-@Deprecated: 2.4: Use g_idle_add_full() instead.
-
-
-<!-- ##### FUNCTION gtk_idle_remove ##### -->
-<para>
-Removes the idle function with the given id.
-</para>
-
-@idle_handler_id: Identifies the idle function to remove.
-@Deprecated: 2.4: Use g_source_remove() instead.
-
-
-<!-- ##### FUNCTION gtk_idle_remove_by_data ##### -->
-<para>
-Removes the idle function identified by the user data.
-</para>
-
-@data: remove the idle function which was registered with this user data.
-@Deprecated: 2.4: Use g_idle_remove_by_data() instead.
-
-
-<!-- ##### FUNCTION gtk_input_add_full ##### -->
-<para>
-Registers a function to be called when a condition becomes true 
-on a file descriptor.
-</para>
-
-@source: a file descriptor.
-@condition: the condition.
-@function: The function to call.
-@marshal: The marshaller to use instead of the function (if non-%NULL).
-@data: callback data passed to @function.
-@destroy: callback function to call with @data when the input
-  handler is removed, or %NULL.
-@Returns: A unique id for the event source; to be used with gtk_input_remove().
-@Deprecated: 2.4: Use g_io_add_watch_full() instead.
-
-
-<!-- ##### FUNCTION gtk_input_remove ##### -->
-<para>
-Removes the function with the given id.
-</para>
-
-@input_handler_id: Identifies the function to remove.
-@Deprecated: 2.4: Use g_source_remove() instead.
-
-
-<!-- ##### MACRO GTK_PRIORITY_REDRAW ##### -->
-<para>
-Use this priority for redrawing related stuff. It is used internally by
-GTK+ to do pending redraws. This priority is lower than %GTK_PRIORITY_RESIZE
-to avoid redrawing a widget just before resizing (and therefore redrawing
-it again).
-</para>
-
-@Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
-
-
 <!-- ##### MACRO GTK_PRIORITY_RESIZE ##### -->
 <para>
 Use this priority for resizing related stuff. It is used internally by
 GTK+ to compute the sizes of widgets. This priority is higher than 
-%GTK_PRIORITY_REDRAW to avoid resizing a widget which was just redrawn.
+%GDK_PRIORITY_REDRAW to avoid resizing a widget which was just redrawn.
 </para>
 
 
-
-<!-- ##### MACRO GTK_PRIORITY_HIGH ##### -->
-<para>
-Use this for high priority timeouts. This priority is never used inside
-GTK+ so everything running at this priority will be running before anything
-inside the toolkit.
-</para>
-
-@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
-
-
-<!-- ##### MACRO GTK_PRIORITY_INTERNAL ##### -->
-<para>
-This priority is for GTK+ internal stuff. Don't use it in your applications.
-</para>
-
-
-
-<!-- ##### MACRO GTK_PRIORITY_DEFAULT ##### -->
-<para>
-Default priority for idle functions.
-</para>
-
-@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
-
-
-<!-- ##### MACRO GTK_PRIORITY_LOW ##### -->
-<para>
-Priority for very unimportant background tasks.
-</para>
-
-@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_LOW instead.
-
-
 <!-- ##### FUNCTION gtk_key_snooper_install ##### -->
 <para>
 Installs a key snooper function, which will get called on all key events
index c1cd7ddf266857c00f9777cfc88851a44b02b997..691876729e0c982d44fe1d537de829aee1871246 100755 (executable)
@@ -9374,20 +9374,20 @@ What if you have a function which you want to be called when nothing
 else is happening ?</para>
 
 <programlisting role="C">
-gint gtk_idle_add( GtkFunction function,
-                   gpointer    data );
+guint g_idle_add( GSourceFunc function,
+                  gpointer    data );
 </programlisting>
 
 <para>This causes GTK to call the specified function whenever nothing else
 is happening.</para>
 
 <programlisting role="C">
-void gtk_idle_remove( gint tag );
+void g_source_remove( guint tag );
 </programlisting>
 
 <para>I won't explain the meaning of the arguments as they follow very much
 like the ones above. The function pointed to by the first argument to
-gtk_idle_add will be called whenever the opportunity arises. As with
+g_idle_add will be called whenever the opportunity arises. As with
 the others, returning FALSE will stop the idle function from being
 called.</para>
 
index 92ff95a1a5340fee4744eda3018f73ee523d1555..ed88d3898d1662c2e7891520b26ff5196369b2ef 100644 (file)
@@ -1063,13 +1063,6 @@ gtk_init_check_abi_check (int *argc, char ***argv, int num_checks, size_t sizeof
 
 #endif
 
-void
-gtk_exit (gint errorcode)
-{
-  exit (errorcode);
-}
-
-
 /**
  * gtk_set_locale:
  *
index 03d5381b68cdd3ba3a6f6ca7ebfd93f164b7f035..33559bbe66002369bb2aea96d5b184acc2fc85aa 100644 (file)
@@ -135,7 +135,7 @@ static void _check_combo_box (AtkObject *obj)
  
   if (!done)
   {
-    gtk_idle_add (_open_combo_list, obj);
+    g_idle_add ((GSourceFunc)_open_combo_list, obj);
     done = TRUE;
   }
   else
@@ -150,7 +150,7 @@ static gint _open_combo_list (gpointer data)
   g_print ("_open_combo_list\n");
   atk_action_do_action (ATK_ACTION (obj), 0);
 
-  gtk_timeout_add (5000, _close_combo_list, obj);
+  g_timeout_add (5000, _close_combo_list, obj);
   return FALSE;
 }
 
index 59e3eb174b4279ac8e443c03cedb238bb831a707..5b8b7247658638d86248be3b48a6e7f8d9192539 100644 (file)
@@ -9847,7 +9847,7 @@ static void
 destroy_progress (GtkWidget     *widget,
                  ProgressData **pdata)
 {
-  gtk_timeout_remove ((*pdata)->timer);
+  g_source_remove ((*pdata)->timer);
   (*pdata)->timer = 0;
   (*pdata)->window = NULL;
   g_free (*pdata);
@@ -10061,7 +10061,7 @@ create_progress_bar (GtkWidget *widget)
       gtk_progress_set_format_string (GTK_PROGRESS (pdata->pbar),
                                      "%v from [%l,%u] (=%p%%)");
       gtk_container_add (GTK_CONTAINER (align), pdata->pbar);
-      pdata->timer = gtk_timeout_add (100, progress_timeout, pdata->pbar);
+      pdata->timer = g_timeout_add (100, (GSourceFunc)progress_timeout, pdata->pbar);
 
       align = gtk_alignment_new (0.5, 0.5, 0, 0);
       gtk_box_pack_start (GTK_BOX (vbox2), align, FALSE, FALSE, 5);
@@ -11067,7 +11067,7 @@ start_timeout_test (GtkWidget *widget,
 {
   if (!timer)
     {
-      timer = gtk_timeout_add (100, (GtkFunction) timeout_test, label);
+      timer = g_timeout_add (100, (GSourceFunc)timeout_test, label);
     }
 }
 
@@ -11077,7 +11077,7 @@ stop_timeout_test (GtkWidget *widget,
 {
   if (timer)
     {
-      gtk_timeout_remove (timer);
+      g_source_remove (timer);
       timer = 0;
     }
 }
@@ -11177,7 +11177,7 @@ start_idle_test (GtkWidget *widget,
 {
   if (!idle_id)
     {
-      idle_id = gtk_idle_add ((GtkFunction) idle_test, label);
+      idle_id = g_idle_add ((GSourceFunc) idle_test, label);
     }
 }
 
@@ -11187,7 +11187,7 @@ stop_idle_test (GtkWidget *widget,
 {
   if (idle_id)
     {
-      gtk_idle_remove (idle_id);
+      g_source_remove (idle_id);
       idle_id = 0;
     }
 }
index cd1817369768fd13c326e1f4de647b85c3877e5c..8230ace2a120fda3a838530499e8997cb9287ca9 100644 (file)
@@ -378,7 +378,7 @@ paste (GtkWidget *widget, GtkWidget *entry)
 void
 quit (void)
 {
-  gtk_exit (0);
+  exit (0);
 }
 
 int
index e717c4ed491f472318cdfd3511c5355fa61bf100..ea2870f9603a1b08a5d54c8c80842b655c5045cd 100644 (file)
@@ -472,7 +472,7 @@ fill_example_buffer (GtkTextBuffer *buffer)
   tag = gtk_text_buffer_create_tag (buffer, "fg_blue", NULL);
 
 #ifdef DO_BLINK
-  gtk_timeout_add (1000, blink_timeout, tag);
+  g_timeout_add (1000, (GSourceFunc)blink_timeout, tag);
 #endif     
  
   setup_tag (tag);